Hbase Java API程序设计步骤

http://www.it165.net/admin/html/201407/3390.html

步骤1:创建一个Configuration对象
   包含了客户端链接Hbase服务所需的全部信息:
   zookeeper位置(我们只有链接到zookeeper才能与hbase通信,master仅负责负载均衡等) ,
   zookeeper链接超时时间


包含各种配置信息,hbase server zookeeper 访问地址和端口号等。
Configutation conf = HbaseConfiguration.create();
create()函数的内部逻辑:
从classpath中加载hbase-default.xml和hbase-site.xml两个文件
hbase-defaut.xml已经打包到Hbase jar包中
hbase-site.xml需要添加到class path中
hbase-site.xml将覆盖hbase-default.xml中的同名属性。

hbase如何找到并从classpath中获取hbase-site.xml信息 ====》如何检查hbase-site.xml已经在hadoop classpath中了呢? 运行 hadoop classpath | grep hbase
1 修改hadoop脚本,将Hbase classpath加入
2 在<hadoop_install>/conf/hadoop-env.sh中设置:
export HADOOP_CLASSPATH=$HBASE_HOME/*:$HBASE_HOME/conf:$HADOOP_CLASSPATH 两个目录放到hadoop的conf的hadoop.env.sh中

如果已经有了一个Configuration文件,可进行如下操作:
Configuration newconf = Configuration.create(existingConf);
用户自定义的配置文件将在已有配置文件之后加载,将覆盖hbase-default.xml hbase-site.xml中的配置

    create
    public static org.apache.hadoop.conf.Configuration create()
    Creates a Configuration with HBase resources
    Returns:
        a Configuration with HBase resources
create public static org.apache.hadoop.conf.Configuration create(org.apache.hadoop.conf.Configuration that) Parameters: that
- Configuration to clone. Returns: a Configuration created with the hbase-*.xml files plus the given configuration.

没有直接从路径添加的构造函数,但是可以构造一个 org.apache.hadoop.conf.Configuration
  /**
   * Add a configuration resource.
   *
   * The properties of this resource will override properties of previously
   * added resources, unless they were marked <a href="#Final">final</a>.
   *
   * @param file file-path of resource to be added, the local filesystem is
   *             examined directly to find the resource, without referring to
   *             the classpath.
   */
  public void addResource(Path file) {
    addResourceObject(new Resource(file));
  }

   可单独覆盖某一个或多个参数值

   Configuration conf = HbaseConfiguration.create();
   conf.set("hbase.zookeeper.quorum", "node1, node2"); 但通常不推荐这么做。 因为需要重新打包,不方便,不如放到配置文件中。

 


步骤2:创建一个HTable句柄
   提供Configuration对象
提供待访问Table名称
HTable table = new HTable(conf, tabName);

》一个table对应一个Htable句柄 这个句柄在org.apache.hadoop.hbase.client.HTable
》提供了CRUD操作 create read update del
》提供行级事务,
不支持多行事务或者表级别事务
严格的行一致性
并发读,顺序写。

创建HTable句柄代价很大
1 扫描.META.表
2 创建一次,以后尽可能复用
3 如果需要创建多个HTable句柄,使用HTableTool

HTable并非线程安全的,一个线程创建一个即可。
Htable支持CRUD批处理,非线程安全,仅是为了提高性能。





步骤3:执行相应的操作
put,get,delete,scan等
table.getTableName();
步骤4:关闭Htable句柄 【句柄不关,会发生内存泄露】
将内存数据刷新到磁盘上。
释放各种资源。
table.close()
package com.jlc.hadoop.hbase.example;

import java.io.IOException;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.hbase.HBaseConfiguration;
import org.apache.hadoop.hbase.client.HTable;
import org.apache.hadoop.hbase.client.Put;
import org.apache.hadoop.hbase.util.Bytes;

public class PutTest {

    public static void main(String[] args) throws IOException {
        Configuration conf = HBaseConfiguration.create();
        HTable hTable = new HTable(conf, "tab1");
        System.out.println(Bytes.toString(hTable.getTableName()));
        
        //步骤一,创建一个put对象
        Put put = new Put(Bytes.toBytes("row1"));
        
        //设置cell值
        //Put.add(family, column, value)
        //Put.add(family, column, timestamp, value)
        //Put.add(KeyValue kv)  KeyValue 事实上就是封装了 上面四个,看起来简单
        
        
        byte[] family = Bytes.toBytes("fam1");
        byte[] qualifier = Bytes.toBytes("col1");
        byte[] value = Bytes.toBytes("val2");;
        put.add(family, qualifier, value);
        
        hTable.put(put);    
        
        hTable.close();
        
//        hbase(main):003:0> scan 'tab1'
//        ROW                   COLUMN+CELL                                               
//         row1                 column=fam1:col1, timestamp=1395796780021, value=val1     
//         row2                 column=fam1:col1, timestamp=1398305517331, value=val2     
//        2 row(s) in 0.0090 seconds
//      若row1 fam1 col1 已经存在,则   scan的时候 显示最新时间戳的那个值,其他的如何获取呢???
//        hbase(main):004:0> scan 'tab1'
//        ROW                   COLUMN+CELL                                               
//         row1                 column=fam1:col1, timestamp=1398305623182, value=val2     
//         row2                 column=fam1:col1, timestamp=1398305517331, value=val2  
        
    }

}
package com.jlc.hadoop.hbase.example;

import java.io.IOException;

import org.apache.hadoop.hbase.HBaseConfiguration;
import org.apache.hadoop.hbase.client.HTable;
import org.apache.hadoop.hbase.util.Bytes;
import org.apache.hadoop.conf.Configuration;

public class ConstructHTable {

    public static void main(String[] args) throws IOException {
        Configuration conf = HBaseConfiguration.create();
        HTable hTable = new HTable(conf, "tab1");
        System.out.println(Bytes.toString(hTable.getTableName()));
        hTable.close();
    }

}
package com.jlc.hadoop.hbase.example;

import java.io.IOException;

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.hbase.HBaseConfiguration;
import org.apache.hadoop.hbase.client.Delete;
import org.apache.hadoop.hbase.client.Get;
import org.apache.hadoop.hbase.client.HTable;
import org.apache.hadoop.hbase.client.Result;
import org.apache.hadoop.hbase.client.ResultScanner;
import org.apache.hadoop.hbase.client.Scan;
import org.apache.hadoop.hbase.util.Bytes;

public class ReadTest {
    
    public static void print(Result result){
        System.out.println("-----------------------------");
        System.out.println("RowId:" + Bytes.toString(result.getRow()));
        byte[] val1 = result.getValue(Bytes.toBytes("fam1"), Bytes.toBytes("col1"));
        System.out.println("fam1:col1=" + Bytes.toString(val1));
        byte[] val2 = result.getValue(Bytes.toBytes("fam1"), Bytes.toBytes("col1"));
        System.out.println("fam1:col1=" + Bytes.toString(val2));
    }
    
    
    public static void scan(HTable hTable, String startrow,String stoprow) throws IOException{
        System.out.println("scaning from " + startrow + " to " + stoprow);
        
        Scan scan = new Scan(Bytes.toBytes(startrow), Bytes.toBytes(stoprow));  // 这个限定了row 但怎么限定列呢
        //scan.addColumn(family, qualifier)
        scan.addColumn(Bytes.toBytes("fam1"), Bytes.toBytes("col1"));   // 这个就指明我们仅仅取某个列就行了
        ResultScanner scanner = hTable.getScanner(scan);    //获取scanner句柄
        for (Result result : scanner) {
//            byte[] value = result.getValue(family, qualifier)
            byte[] value = result.getValue(Bytes.toBytes("fam1"), Bytes.toBytes("col1"));
            System.out.println(Bytes.toString(result.getRow()) + "=>" + Bytes.toString(value));
        }
        scanner.close();//  这个不要忘记哦
    }
    

    public static void main(String[] args) throws IOException {

        /*
         * 支持的API类型 通过rowkey获取一行数据 通过rowkey集合获取多条记录 扫描整个表或者表的一部分
         * 
         * 扫描表:可指定扫描的范围,[startkey, endkey] 表中数据是按照rowkey排序的
         * 
         * 读取时的注意事项: 1 只读取需要的数据
         * [比方我只读取某个columnfamliy里某一个column的数据,指定这一列就行了,不要都读取出来,浪费io] 2
         * 尽可能的增加数据约束条件 3 可增加family, column(s) time range 和 max
         * versions【我要返回多少个版本号】等约束条件
         * 
         * 接口实例:get.setTimeRange(minStamp, maxStamp) 这个就是增加时间范围, time range
         * get.setMaxVersions(maxVersions)get.addFamily(family) 只后去众多familys
         * 中的一个familyget.addColumn(family, column)
         * 只获取某个family的众多columen中的一个column的数据
         */
        
        Configuration conf = HBaseConfiguration.create();
        HTable hTable = new HTable(conf, "tab1");
        System.out.println(Bytes.toString(hTable.getTableName()));
        
//        byte[] family = Bytes.toBytes("fam1");
//        byte[] qualifier = Bytes.toBytes("col1");
//        byte[] value = Bytes.toBytes("val2");;
        
        
        
        // get example
//        Get get = new Get(Bytes.toBytes("row1"));
//        Result result = hTable.get(get);
//        print(result);
        
        //有时候我们不需要整个row里的所有数据,我们可以加以限制 [推荐使用这种限制的]
//        get.addColumn(Bytes.toBytes("fam1"), Bytes.toBytes("col1"));
//        result = hTable.get(get);
//        print(result);
        
//        keyvalues={row1/fam1:col1/1398305623182/Put/vlen=4/mvcc=0}
//        keyvalues={row1/fam1:col1/1398305623182/Put/vlen=4/mvcc=0}
        
        //delete example
        //Delete delete = new Delete(Bytes.toBytes("rowtodel"));
        //hTable.delete(delete);

        //Delete delete1 = new Delete(Bytes.toBytes("another row"));
        //delete1.deleteColumn(family, qualifier)
        //hTable.delete(delete1);
        
        //scan example
        scan(hTable, "row1", "row3"); //前闭 后开的  要得道前两行,需要指定到第三行
        hTable.close();
        
    }

}

 

 

 

 

posted on 2014-04-24 11:05  雨渐渐  阅读(799)  评论(0编辑  收藏  举报

导航